EZLink 快速上手指南

欢迎使用 EZLink！这是一款强大而轻量级的网络管理与远程控制工具。仅需几分钟，您就可以将设备连接起来并进行高效管理。

🎛️
控制端 (Controller)

操作员使用

操作员在控制端发起连接，可连接多个网络分组并管理在线设备，通过控制面板进行远程桌面、文件传输等深度操作。

💡 提示：可拖拽四角调整大小及Ctrl+鼠标滚轮缩放界面。
💻
被控端 (Managed)

运行在目标设备

启动被控端软件后，该设备将具备被远程接管和控制的能力，主要提供远程组网、屏幕共享、文件接收服务。

💡 提示：被控端启动后会自动配置防火墙等必要设置。

准备工作：安装运行环境 仅控制端需要

⚠️

首次运行必装环境

EZLink 控制端 首次在您的电脑上运行时，请务必依次下载并双击安装以下两个官方运行环境（如已安装可跳过）。

🛡️

重要：关闭杀毒软件

为保证网络组网及底层通信服务的正常运行，请务必在运行前退出或关闭杀毒软件（如 360安全卫士、电脑管家、Windows Defender 等），否则核心网络组件可能会被误拦截导致连接失败。

🌐
必需组件 1

ASP.NET Core 运行时

环境版本: 8.0.25 | 提供核心网络通信及后台服务运行基础
🖥️
必需组件 2

.NET 桌面运行时

环境版本: 8.0.25 | 提供控制端桌面 UI 图形界面的正常显示

快速使用流程

1

启动「控制端」并创建网络分组

作为操作者，首先在您的电脑上打开 EZLink.Controller。进入主界面后，创建一个新的网络分组并设定组网名称。

2

在目标设备启动「被控端」加入组网

启动 EZLink.Managed 前，请先用“记事本”打开 config/settings.json，并将 ActiveNetwork 参数修改为您创建的组网名称（例如："ActiveNetwork": "组网1"）。

3

设置目标网段并建立「子网连接」

回到控制端，您可以在分组列表中看到该目标设备已上线。填写目标网段后，选中该设备，接着点击连接子网按钮即可自动保存并连接。

4

开始远程管理与操作

设备上线后，您即可在“控制面板”中直接使用远程桌面和文件传输功能。若需连接 PLC 等远端局域网设备，则必须在完成“子网连接”后方可进行操作。

主要功能亮点

🖥️ 远程桌面

内置基于 H.264 硬件加速的画面编解码技术，相比传统方案延迟更低、画质更清晰，极大提升了远程操作体验。

💡 注意：Windows 原生远程桌面不支持家庭版系统，一些免费工具激活的企业版也有可能组件损坏导致无法远程（有办法修复）。

🛠️ 展开查看：解除 RDP 限制与修复补丁步骤

⚠️ 安全软件警告（必看）：由于补丁的原理是动态修改系统级核心文件，杀毒软件（Defender、360、火绒等）会报毒并立刻拦截。下载和解压前，务必将其所在文件夹加入杀毒软件白名单/信任区，否则核心文件会被立刻删掉。

  1. 官方下载与安装
    • 前往 RDPWrap 发布页 下载最新的 RDPWrap-v1.6.2.zip。
    • 解压后右键点击 install.bat，选择“以管理员身份运行”。
    • 等待黑色控制台窗口跑完代码提示成功。安装后双击运行目录里的 RDPConf.exe。
  2. INI 补丁更新（极其重要）

    由于 Windows 10/11 经常更新底层代码，若 RDPConf 显示红字 [not supported]，需更新配置文件：

    • 复制 社区最新 INI 文件 的全部内容。
    • 在系统服务 (services.msc) 里停用 Remote Desktop Services。
    • 前往 C:\Program Files\RDP Wrapper 目录，用记事本打开 rdpwrap.ini，替换全部内容并保存。
    • 重新启动服务，再次打开 RDPConf.exe，确保字变成绿色的 [fully supported] 和 [listening]。
  3. 解决端口未监听问题 (Not listening)

    如果 Listener state 依然是红色的 Not listening，请按以下两招顺序操作，必定解决：

    • 第一招：激活状态机（最快）
      在 RDPConf 界面，取消勾选左侧的 Enable Remote Desktop -> 点击右下角 Apply -> 停顿两秒 -> 重新勾选 -> 再次点击 Apply。如果变绿则大功告成。
    • 第二招：修复系统证书权限死穴（第一步无效时必用）

      常见于克隆或精简系统，RDP 服务生成加密证书时被拒绝导致监听失败。

      • 按 Win + R，直接输入隐藏路径 C:\ProgramData\Microsoft\Crypto\RSA\ 并回车。
      • 找到 MachineKeys 文件夹，右键 属性 -> 切换到 安全 选项卡。
      • 点击 编辑，在列表中选中 Everyone （如果没有则点击“添加”输入 Everyone），在下方权限列表给 “完全控制” 的“允许”框打勾，点击确定保存。
      • 重启这台电脑！！！ 重启系统服务后再次打开 RDPConf.exe 即可三行全绿，主控端即可畅通连入。

📁 文件传输

采用类似 VNC 的传输逻辑，并集成了 Windows 原生进度对话框显示传输状态。

⚡ 子网连接

建立子网连接后，控制端即可透明访问被控端所在的整个局域网网络，轻松连接并管理被控端下的所有局域网设备，如 PLC、HMI 及工业终端设备。

⚙️ 组网管理

一台控制端可以轻松加入并管理多个不同的网络分组。通过直观的设备列表，随时掌握所有在线被控节点的状态并实现一键远控。

🔄 被控端程序更新

升级无忧：仅需将新版 update.zip 通过文件传输功能发送至被控端根目录

① 检测更新包
启动时自动识别根目录下的 update.zip
② 安全退出旧版
生成更新脚本并等待当前进程完全退出
③ 解压覆盖安装
自动解压 update.zip 覆盖程序文件
④ 清理并重启
删除更新包并自动启动新版本服务

💡 提示：如程序在运行中，再次点击程序图标即可自动重启并应用更新。

📦 软件通用更新与配置保留

此说明适用于 EZLink 的所有程序（包含控制端、被控端及服务端）：

💡
配置保留方法
当软件版本更新时，只需将旧版本程序根目录下的 config 文件夹，完整复制并覆盖到新版本程序根目录，即可无缝保留您之前的网络配置、连接记录等所有信息。

组态示例图

graph LR A["🎛️ 控制端
(目标网段配置: 10.168.1.10)"] -- 远程组网连接 --> B["💻 被控端"] B -- 物理以太网连接 --> C["🗄️ 目标 PLC
(物理IP: 10.168.1.10)"] style A fill:#eff6ff,stroke:#2563eb,stroke-width:2px,color:#1e40af style B fill:#ecfdf5,stroke:#10b981,stroke-width:2px,color:#065f46 style C fill:#fffbeb,stroke:#f59e0b,stroke-width:2px,color:#92400e
💡 组网说明：
  • 被控端网络前提（重要）：被控端所在的电脑或设备，其物理网卡必须与 PLC 在同一局域网内，即被控端必须能 Ping 通 PLC。这是实现底层远程穿透的物理前提。
  • PLC 真实 IP：被控端物理网口直接连接的 PLC 设备的真实局域网 IP（本示例为 10.168.1.10）。
  • 控制端目标网段：为了让控制端通过隧道访问到远端局域网的 PLC，必须在控制端的目标子网配置为该 PLC 的同网段地址（本示例填写 10.168.1.10 或 10.168.1.0/24 均可）。配置后，控制端即可如同在现场一般直接访问远端设备。
  • ⚠️ 无法自动搜索说明（重要）：在当前的组网模式下，不能通过编程软件自动搜索到 PLC。您必须要手动指定 PLC 的 IP 地址才能进行连接和程序下载等操作。

组网操作演示

组网及子网连接操作步骤
💡 提示：设备连接前请务必配置 PLC 的 IP 地址（例如：在西门子 STEP7 中添加 CPU 并分配 IP），否则将无法正常通信。